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TITLE TSOVR - Overlay handler for mapped system regions 

Thi& overlay handler replaces the normal RTll handler in SYSLIB at link 
time. ihe calling sequence remains the same as documented in the RT-11 
System User's Guide chapter 11. This handler is called by a dummy 
subroutine of the following form: 

JSR R5i *DVRH icall to common code for overlays 

.WORD <aVERLAY # «- 6> j# of desired segment 

.WORD <ENTRY ADDRESS> ;actual core address (virtual) 

This routine intercepts the overlay request and maps KPAR5 to the 
address in physical memory where the segment was loaded. 



. PSECT 0*HAND, GBL 

Global definitions 

. GLOBL *OVRH, OVRLEN, OVRHC, OVRADD, *OVTAB, 0*HAND 

Global references 

. GLOBL PSW, SYSMAP, HAPSYS 

. ENABL LC 



save a pointer to the argument list 

obtain the segment number of the system region 

call the mapping system routine 

restore the pointer to the argument list 

get to the module entry point 

obtain entry of address of mapped module 

enter the system mapped region 

length of the overlay handler 



O^HAND: 






*DVRH: 








MOV 


R5, -<SP) 




MOV 


(R5),R5 




CALL 


MAPSYS 




MOV 


<SP)+, R5 




TST 


<R5) + 




MOV 


@R5. R5 




RTS 


R5 



OVRLEN = . - *OVRH 



OVRHC is used by the root and mapped regions to call other mapped 
regions. It preserves the currently mapped region* sets a return address^ 
and calls the system overlay handler. Upon return* it restores the 
previously mapped region and returns to the caller. 
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OVRHC: MOV (SP),-<SP) 

MOV @#KPAR5, -<SP) 

MOV #OVRET, -(SP) 

MOV e4(SP)*-<SP) 

ADD #2, 6(SP) 

JMP @ ( SP ) + 



; move the return address douin one location 

i save the system mapping region on the stack 

j save the return address on the stack 

i obtain the entry address 

; set return past the module overlay address 

; jump into the overlay handler 



OVRET will return from the OCALL macro. 

The C~bit must be preserved on entry until the return. 



OOOOOOG 000004 
OOOOOOG 



OVRET: 



MOV 
MOV 
RTI 



@#PSW, 4(SP) 
<SP)+, ©#KPAR5 



OVRADD: : . WORD *OVTAB 

r 

i Overlay table structure: 



; save the current psw 

j restore system overlay mapping 

* return to the caller 

i point to overlay handler table 
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Errors detected: O 



lot 64 — > *OVTAB: 

. WORD <IDENTIFIER>, <KPAR5>, <WORD COUNT> 
DUMMY SUBROUTINES FOR ALL OVERLAY SEGMENTS 

. PSECT $OTABL, D, GBL, OVR 



^OVTAB: ; 



END 



«•** Assembler statistics 



Work file reads: 

Work file writes: 

Size of work file: 45 Words ( 1 Pages) 

Size of core pool: 17920 Words ( 70 Pages) 

Operating system: RT-11 



Elapsed time: 00:00:02.27 

DK: TSOVR, LP: TS0VR=DL1: TSOVR. MAC/C/N; SYM 



TSOVR - Overlay handler- for map MACRO V05. 04 Thursday 17-Dec-87 15:53 Page S~l 
Cross reference table <CREF V05. 04 ) 

l~aA« 1-34 

1-55 l-65# 

l-52«- 

1-29 

l-25# 

l-55# 

1-51# 

i-41# 

l-34# 

1-51 



*DVRH 




-19 


*OVTAB 




-19 


KPAR5 




-42 


MAP SYS 




-22 


0*HAND 




-19 


OVRADD 




-19 


OVRET 




-43 


OVRHC 




-19 


OVRLEN 




-19 


PSW 




-22 


SYSMAP 




-22 



